home *** CD-ROM | disk | FTP | other *** search
/ Sky at Night 2007 October / SAN CD 10-2007 CD-ROM 29.iso / pc / Software / KeithsImageStacker / KIS / README < prev    next >
Encoding:
Text File  |  2004-04-01  |  8.3 KB  |  66 lines

  1. Keith's Image Stacker 4.2
  2.  
  3. ################################################################################
  4. # INTRODUCTION #
  5. ################
  6.  
  7. Keith's Image Stacker is an image-processing program oriented primarily at amateur astrophotographers.  This program lets you bring a quicktime movie or a series of image files into a workspace.  Once in the workspace you can align the individual frames to one another and then "stack" them, which gives you an average.  The resulting image will have a higher signal-to-noise ratio than the individual frames.
  8.  
  9. This program also has a host of post-processing commands including darkframe subtraction (for those pesky thermal noise blemishes on you webcam's ccd), flat frame field division, gaussian blur, unsharp mask, laplacian sharpening, level-adjustment, noise reduction, and Fourier transform editing.
  10.  
  11. ################################################################################
  12. # SHAREWARE #
  13. #############
  14.  
  15. This program is highly affordable shareware.  For the endless hours of work I have put into creating this utility I ask that you please pay me $10.00, which automatically registers you for all future versions.  In return I will place you on an extremely infrequent mailing list to be directly notified of version updates when they occur.  I can be paid in two ways.  One, by paypal to the account kwiley@cs.unm.edu (I cannot accept paypal credit card payments however, only bank transfers, which are free incidentally), or two, by personal check or cash.  Since my mailing address may change from time to time, I will not put it here.  Instead, email me if you are interested in paying by that method.
  16.  
  17. ################################################################################
  18. # IMPORTANT NOTES #
  19. ###################
  20.  
  21. It is highly recommended that you read, if not at least peruse, the documentation.  It is quite short and will help greatly in your basic understanding of the proper usage of the program and its many tools.  Please read the documentation first.
  22.  
  23. There are a commands-list window and a hints window in the program that should explain most of the unobvious commands.  If the program beeps, you have tried something illegal.  For example, if you try to autoalign without defining an autoalignment rectangle, or if you try to subtract a darkframe but you have not opened a darkframe picture.
  24.  
  25. The image size will be set by the first movie or image file you bring into the workspace (you'll see the dimensions written in the lower-left corner of the Frame Inspector Window).  Subsequent image files will be forced into those dimensions if they don't match, while subsequent movies will provide you with a cropping rectangle that matches the specified dimensions.  Darkframe and Flatfield files will also be forced to fit the image dimensions if they don't match.
  26.  
  27. To inspect individual pixel values, select the window in question and then move the mouse over the Frame Inspector Window, SumStack Window, Darkframe Window, or Flat Field Frame Window.  A small window will pop up showing you the color components in red, green, blue and hue, saturation, value.  Of course, the only way for this to work in the Frame Inspector Window is if exactly one frame is selected, no more, no less.  Otherwise there won't be an image in that window.
  28.  
  29. The text written over each clip correspond to the clip id (upper left corner), score assuming you have sorted the frames (lower left corner), 'D' if a particular frame has been darkframe subtracted, 'F' if a particular frame has been flat field divided, and 'B' if a particular frame has been deBayerized.  In the Frame Inspector Window, the text corresponds to the index out of the total number of frames (upper left corner), the image dimensions (lower right left), RGB alignments (lower left corner), and a 'D', 'F', and 'B' again for darkframe subtraction, flatfield division, and deBayering.
  30.  
  31. You can resize the Frame Inspector Window, the SumStack Window, Darkframe Window, and Flat Field Frame Window to any dimension-proportion-constrained size between 40x30 and 4000x3000.  To set the window back to the image dimensions, click the zoom box.  Likewise, the zoom box in the clips window will resize that window to fit the clips.
  32.  
  33. The '1', '2', and '3' keys have two very different functions.  Holding one of these three keys down simultaneously specifies auto-alignment sizes and red, green, or blue channels.  Which of these two meanings is in effect depends on the operation being performed.  For example, if you hold down the '1' key and click on a clip in the Clips Window, the '1' key is specifying the auto-alignment size, but if you hold down the '1' key and tap an arrow key, you will manually nudge the red channel of that same clip by one pixel, assuming the Align Channels Separately menu item is checked.
  34.  
  35. Likewise, use the '1', '2', and '3' keys to manually nudge the RGB channels in the final FrameStack if you want to adjust the channel alignments there as well.
  36.  
  37. Some commands won't let you stop them (with the Stop button in the Working dialog).  Just be aware of this fact.
  38.  
  39. The images this program operates on in the Clips Window are 32 bits deep (8 bits per pixel component red, green, and blue with 8 left over), although the stacked image is 96 bits deep, 32 bits per channel.  If your screen is set to less than millions of colors, the images will be dithered as they are drawn to the screen.  However, the color values shown in the color values popup window (visible whenever the mouse is over the Frame Inspector Window, the SumStack Window, the DarkFrame Window, or the Flat Field frame Window *and* that window is selected) and the color values used to calculate the histograms will be the true 32 bit color values stored in memory, not the lower depth color displayed on your screen.  Of course, setting your screen to millions of colors alleviates any confusion on this matter altogether.  There is a specific page in the documentation which discusses this issue.
  40.  
  41. As the available memory fills up, individual images will be pushed off to temp files on the disk (only in OS 9, OS X has its own virtual memory system built in).  You will need a respectable amount of disk space for this to succeed.  Accessing these temp files will be slow, so the more images you have in memory, the faster things will run.  The program will automatically keep its memory saturated if you perform an operation that frees up some memory (deleting an image, cropping, or resampling down in size).
  42.  
  43. When saving FITS files, the bit depth will automatically be set to 16 or 32 for you depending on whether 16 bits is sufficient, which occurs when the brightest value of any pixel component in the image is less than or equal to 65535.  If this is not the case the FITS files are automatically saved at 32 bits.
  44.  
  45. The menu option to open FITS files and Raw files will be disabled whenever the Clips Window is visible, which only occurs when there are one or more images in the stacking workspace.  You must close the Clips Window or delete all the clips in order to open FITS files or Raw files into the FrameStack.
  46.  
  47. ################################################################################
  48. # KNOWN BUGS #
  49. ##############
  50.  
  51. The interaction between the preview rect, the Preview On button in many dialogs, and the meny commands for toggling RGB channel views aren't buggy, but can be confusing an nonintuitive in some respects.  I am still experimenting with the best way of integrating these features together.
  52.  
  53. The autoalignment commands can get "stuck" sometimes.  The symptom of this is that if you try to toggle a frame's sum/stack inclusion, it will autoalign instead of drawing or removing an X over the frame.  The only way to fix this is to tap the autoalign number keys again.
  54.  
  55. Using the return key or command-period to execute OK button and Cancel button commands will often be a little ugly in appearance.  Also, if you use the return key to select a movie to open (as opposed to using the mouse) this will automatically accept the first frame of the movie without giving you a choice.
  56.  
  57. Some kinds of out-of-memory errors won't be cleanly detected.  The program will crash and quit when these errors occur.  It shouldn't freeze the computer though, not in my experience at least.
  58.  
  59. ################################################################################
  60. # CONTACT #
  61. ###########
  62.  
  63. 040401
  64. Keith Wiley
  65. kwiley@cs.unm.edu
  66. http://www.unm.edu/~keithw